home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / disk & file tools / muienv / muienv.dok < prev    next >
Text File  |  1996-04-07  |  7KB  |  206 lines
  1. MuiEnv 1.6
  2. **********
  3.  
  4.                       Dokumentation zu MuiEnv 1.6
  5.  
  6.              Datum: 16. März 1995  Autor: Michael Suelmann
  7.  
  8. Copyright
  9. *********
  10.  
  11.    MuiEnv 1.6 ist Freeware und darf frei kopiert und benutzt werden,
  12. solange es komplett mit Dokumentation weitergegeben wird.
  13.  
  14.    Die Benutzung von MuiEnv ist auf eigene Gefahr. Der Autor kann nicht
  15. für Schäden haftbar gemacht werden, die durch die Anwendung dieses
  16. Programms entstehen.
  17.  
  18.    MuiEnv ist Copyright (C) 1993 Michael Suelmann.
  19.  
  20. Übersicht
  21. *********
  22.  
  23.    MuiEnv ist ein Programm zur Manipulation von Umgebungsvariablen.
  24. Mit MuiEnv kann man Umgebungsvariablen editieren, sichern, laden,
  25. löschen, umbenennen und neu anlegen.
  26.  
  27.    Im Gegensatz zu anderen Programmen dieser Art, unterstützt MuiEnv
  28. auch Unterverzeichnisse in ENV: und ENVARC:
  29.  
  30.    MuiEnv benutzt MagicUserInterface, Copyright (C) 1993 Stefan Stuntz.
  31.  
  32. Voraussetzungen
  33. ***************
  34.  
  35.    MuiEnv 1.6 läuft nur mit Version 2.04 (37.175) oder höher des
  36. Amiga-Betriebssystems.
  37.  
  38.    MuiEnv benutzt MagicUserInterface von Stefan Stuntz.
  39. MagicUserInterface wird nicht mitgeliefert. Es ist z.B. erhältlich als
  40. dev/gui/mui23usr.lha im Aminet.
  41.  
  42. Installation
  43. ************
  44.  
  45.    Zur Installation kann man einfach das Programm MuiEnv in ein
  46. beliebiges Verzeichnis im AmigaDOS-Pfad kopieren.
  47.  
  48.    Als externen Editor für Umgebungsvariablen wird $EDITOR benutzt.
  49. Deshalb muß mit SetEnv EDITOR Programmname oder mit MuiEnv selbst
  50. die EDITOR-Variable gesetzt werden.
  51.  
  52.    Alternativ kann der Editor mit dem ToolType oder Shell-Parameter
  53. EDITOR eingestellt werden.
  54.  
  55.    Analog wird HEXEDITOR bei Edit hex. benutzt.
  56.  
  57. Aufruf
  58. ******
  59.  
  60.    MuiEnv kann von Workbench oder CLI aus gestartet werden.
  61.  
  62.    Für den Aufruf vom CLI aus gilt folgende Befehlsschablone:
  63.  
  64.        FILE,EDITOR/K,HEXEDITOR/K
  65.  
  66. FILE gibt eine Datei an, die beim Start editiert werden soll.
  67.      Ist FILE ein Verzeichnis, so wird dieses beim Start angezeigt.
  68.  
  69. EDITOR/K gibt den Editor an, der bei Edit ext.
  70.      benutzt wird.
  71.  
  72. HEXEDITOR/K gibt den Editor an, der bei Edit hex.
  73.      benutzt wird.
  74.  
  75. Bedienelemente
  76. **************
  77.  
  78.    MuiEnv öffnet ein Fenster mit einem Listview mit String-Gadget und
  79. mehreren Button-Gadgets.
  80.  
  81.    Im Listview wird die aktuelle Umgebungsvariable angezeigt, die mit
  82. Pfeiltasten oder Maus ausgewählt werden kann.
  83.  
  84.    Mit TAB kann zwischen dem Listview und dem String-Gadget umgeschaltet
  85. werden. Gültig für die folgenden Funktionen ist immer der Inhalt des
  86. String-Gadgets.
  87.  
  88.    Mit RETURN oder einem Doppelklick im Listview wird bei einem
  89. Verzeichnis in das Verzeichnis gewechselt, bei einer kurzen Variable
  90. wird der Edit-Button ausgeöest und bei einer langen Variable oder
  91. einer Variable, die Null-Bytes enthält, wird der Edit ext.-Button
  92. ausgelöst.  Dies funktioniert auch bei aktiviertem String-Gadget.
  93.  
  94.    Der Edit-Button öffnet ein neues Fenster mit String-Gadget zum
  95. Ändern der aktuellen Umgebungsvariablen und drei Button-Gadgets:
  96. Save speichert die Umgebungsvariable in ENV: und ENVARC:,
  97. Use speichert nur in ENV: und Cancel bricht ab.  Der
  98. Edit-Button ist gesperrt bei Verzeichnissen und nicht
  99. vollständig darstellberen Variablen.
  100.  
  101.    Der Edit ext.-Button ruft einen externen Editor auf, um den Inhalt
  102. der aktuellen Umgebungsvariablen zu editieren.  Der Editor kann über
  103. ToolType/Shell-Parameter EDITOR eingestellt werden.  Default ist
  104. $EDITOR.  Der Edit ext.-Button ist bei Verzeichnissen gesperrt.
  105.  
  106.    Der Edit hex.-Button ruft einen externen Hex-Editor auf, um den
  107. Inhalt der aktuellen Umgebungsvariablen zu editieren.  Der Hex-Editor
  108. kann über ToolType/Shell-Parameter HEXEDITOR eingestellt werden.
  109. Default ist $HEXEDITOR.  Der Edit hex.-Button ist bei
  110. Verzeichnissen gesperrt.
  111.  
  112.    Mit dem Save-Button wird die aktuelle Umgebungsvariable von
  113. ENV: nach ENVARC: kopiert.
  114.  
  115.    Mit dem Reload-Button wird die aktuelle Umgebungsvariable von
  116. ENVARC: nach ENV: kopiert.
  117.  
  118.    Der Delete-Button löscht die aktuelle Umgebungsvariable in
  119. ENV: und/oder ENVARC:. Ein Requester erscheint, um anzugeben,
  120. ob nur in ENV:, oder auch in ENVARC: gelöscht werden soll.  Ein
  121. Verzeichnis wird dabei mit Inhalt gelöscht.
  122.  
  123.    Der Rename-Button öffnet ein neues Fenster mit String-Gadget zum
  124. Ändern des Namens der aktuellen Umgebungsvariablen und drei
  125. Button-Gadgets: Save benennt die Umgebungsvariable in ENV: und
  126. ENVARC: um, Use benennt nur in ENV: um und Cancel bricht ab.
  127.  
  128.    Der MakeDir-Button öffnet ein neues Fenster mit String-Gadget zum
  129. Erzeugen eines neuen Unterverzeichnisses und drei Button-Gadgets:
  130. Save erzeugt das Unterverzeichnisses in ENV: und ENVARC:,
  131. Use erzeugt es nur in ENV: und Cancel bricht ab.
  132.  
  133.    Mit dem Rescan-Button wird der Inhalt des Listview erneuert.
  134.  
  135.    Mit dem Parent-Button wird der Inhalt des übergeordneten
  136. Verzeichnisses im Listview angezeigt.
  137.  
  138.    Der Update all-Button kopiert alle Dateien aus ENVARC: nach ENV:,
  139. die noch nicht in ENV: existieren.  Dies kann nützlich sein, falls ein
  140. neu installiertes Programm seine Umgebungsvariablen nur nach ENVARC:
  141. kopiert hat oder Variablen in ENV: gelöscht wurden.
  142.  
  143.    Der Quit-Button beendet MuiEnv.
  144.  
  145.    Neue Variablen werden erzeugen, indem man im String-Gadget einen
  146. neuen Variablenamen angibt und dann Edit aufruft bzw. RETURN drückt.
  147.  
  148.    Das Fenster von MuiEnv ist ein AppWindow.  Wenn man ein Icon auf das
  149. fenster Fallen läßt, kopiert MuiEnv die entsprechende Datei ins
  150. aktuelle ENV:-Verzeichnis.
  151.  
  152. Geschichte
  153. **********
  154.  
  155.    1.0, Datum 5.10.93
  156.    - erste veröffentlichte Version
  157.  
  158.    1.1, Datum 29.10.93
  159.    - Enforcer-Hit entfernt
  160.  
  161.    - Neue Button-Gadgets MakeDir und About
  162.  
  163.    1.2, Datum 14.11.93
  164.    - Edit-Funktion speichert nun nicht nur 80 Zeichen ab, sondern alle.
  165.  
  166.    - Edit- und Edit ext.-Button werden bei Verzeichnissen gesperrt.
  167.  
  168.    - Verbessertes Verhalten bei leeren Verzechnissen
  169.  
  170.    1.4, Datum 19.01.95
  171.    - Stackgröße erhöht (hat Abstürze verursacht).
  172.  
  173.    - Save- und Reload-Button werden bei Verzeichnissen gesperrt.
  174.  
  175.    - Delete fragt nun nach, wo gelöscht werden soll.
  176.  
  177.    - ToolType EDITOR wird für Edit ext. benutzt.
  178.  
  179.    1.5, Datum 05.02.95
  180.    - MuiEnv hat nun ein AppWindow. Wenn man ein Icon fallen läßt, wird
  181.      die Datei nach ENV: kopiert.
  182.  
  183.    1.6, Datum 16.03.95
  184.    - neuer Button Edit hex.
  185.  
  186.    - neuer Button Update all
  187.  
  188.    - About-Button entfernt. Menüeintrag About existiert weiterhin.
  189.  
  190.    - Befehlsschablone für CLI-Benutzung hinzugefügt.
  191.  
  192. Autor
  193. *****
  194.  
  195.    Bitte schickt mir Anregungen, Kritik und Bugreports.
  196.  
  197.      Adresse:
  198.          Michael Suelmann
  199.          Neuburger Straße 61
  200.      
  201.          D-94032 Passau
  202.      
  203.      E-Mail:
  204.          suelmann@forwiss.uni-passau.de
  205.  
  206.